home *** CD-ROM | disk | FTP | other *** search
/ Mac Magazin/MacEasy 32 / Mac Magazin and MacEasy Magazine CD - Issue 32.iso / Grafik & Text / OzTeX3.0 / BibTeX / Reporting Bugs < prev   
Text File  |  1997-02-20  |  3KB  |  84 lines
  1. Reporting Bugs in Mac BibTeX
  2. ============================
  3.  
  4. Please send me (<mailto:darley@fas.harvard.edu>) details of:
  5.  
  6.     • Machine type (PowerPC or 68k; I don't care so much which model).
  7.     • System (7/7.1/7.5/7.5.3/7.6…).
  8.     • Version of Mac BibTeX you are using (make sure it's the latest!).
  9.     • Circumstances of the bug.
  10.  
  11. Also please try repeating the bug after restarting your machine with 
  12. extensions off (hold down shift during restart).  If this resolves your 
  13. problem then you have an extension conflict.  You'll have to work out which 
  14. extension/control panel doesn't like BibTeX and remove it or upgrade to a 
  15. newer version.
  16.  
  17. If at all possible, please try and give me a sequence of actions which 100% 
  18. reproducibly exhibit your bug.  If necessary send me .aux, .blg files etc.
  19.  
  20. There are known cosmetic bugs in which the log window is not cleared 
  21. correctly, or scrolled back to the top correctly.  At least some of these
  22. seem to be inadequacies/'features' of the Powerplant class I'm using,
  23. which is v. annoying.  I'll gradually make it work perfectly, but it's
  24. not a high priority.  So please only report peculiar bugs in that category.
  25.  
  26. thanks,
  27.  
  28.     Vince.
  29.     
  30. "Not enough memory for BibTeX processing..."
  31. ============================================
  32.  
  33. This isn't a bug.  BibTeX uses a lot of temporary memory to do its 
  34. processing.  If it's not available, it can't run.  Even if it seems there 
  35. should be enough memory available, sometimes you'll get errors.  The reason 
  36. this varies is that available memory can sometimes be quite large, but 
  37. fragmented, so BibTeX can't find blocks which are big enough.
  38.  
  39. What can you do?
  40.  
  41. Use virtual memory or ram doubler, or get more memory, or quit other 
  42. applications.
  43.  
  44. What might help?
  45.  
  46. Make sure you haven't clicked the 'Big BibTeX' preferences option.  It    
  47. needs even more memory at that setting.
  48.  
  49. What won't really help?
  50.  
  51. Giving BibTeX itself more memory won't help (unless you give it lots, but 
  52. then you'll have to quit other applications anyway...).  It already looks 
  53. in both the system heap (temporary memory) and its own heap (the 'get info' 
  54. allocation).
  55.  
  56. Reporting Bugs when command clicking to Alpha
  57. =============================================
  58.  
  59. If command-clicking switches you to Alpha, but what happened subsequently 
  60. seems wrong (i.e.  you don't end up at the line of the error), then you 
  61. need to give me a trace of the BibTeX-Alpha interaction, as well as the 
  62. text in BibTeX's log window.  Do the following:
  63.  
  64. Switch to Alpha, hit cmd-Y, hit shift-cmd-Z, select 'GURLHandler' from the 
  65. list which appears, switch back to BibTeX, repeat the problematic 
  66. cmd-click, switch to Alpha, hit cmd-Y, hit shift-cmd-D, and mail me the 
  67. trace-dump which should appear in a new window at that point.  Also copy 
  68. the errant text out of BibTeX's log window, and send that to me.  If no 
  69. trace-dump window appears, the problem is on the BibTeX/Appleevent end of 
  70. things, and in that case just send me the text which caused the problems.
  71.  
  72. -----------------------------
  73. Also (for helpful souls with MacsBug):
  74.  
  75. If you are dumped into MacsBug, please grab a stack trace.  You
  76. can do this by typing:
  77.     LOG bibcrashlog
  78.     sc6
  79.     HOW
  80.     STAT
  81. Then send me the file 'bibcrashlog' which will appear on your
  82. desktop.  Many thanks; it'll help me to track down and fix the bug.
  83.  
  84.